home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / newsgroups / misc.20010921-20020314 / 000060_sobrado@string1…cias.uniovi.es_Mon Oct 22 10:02:17 EDT 2001.msg < prev    next >
Text File  |  2020-01-01  |  2KB  |  47 lines
  1. Article: 12872 of comp.protocols.kermit.misc
  2. Path: newsmaster.cc.columbia.edu!panix!nycmny1-snh1.gtei.net!cpk-news-hub1.bbnplanet.com!news.gtei.net!news.maxwell.syr.edu!news-ge.switch.ch!news.rediris.es!newsfeed.uniovi.es!not-for-mail
  3. From: Igor Sobrado <sobrado@string1.ciencias.uniovi.es>
  4. Newsgroups: comp.protocols.kermit.misc
  5. Subject: Re: Dumb question about man pages
  6. Date: 22 Oct 2001 13:24:24 GMT
  7. Organization: Universidad de Oviedo
  8. Lines: 29
  9. Message-ID: <9r16m8$pp8$1@news01.si.uniovi.es>
  10. References: <9ql2ht$q2s$1@newsmaster.cc.columbia.edu> <ur8s17s7a.fsf@worldnet.att.net>
  11. NNTP-Posting-Host: string1.ciencias.uniovi.es
  12. X-Trace: news01.si.uniovi.es 1003757064 26408 156.35.97.40 (22 Oct 2001 13:24:24 GMT)
  13. X-Complaints-To: abuse@si.uniovi.es
  14. NNTP-Posting-Date: 22 Oct 2001 13:24:24 GMT
  15. User-Agent: tin/1.4.3-20000502 ("Marian") (UNIX) (Linux/2.2.16 (i586))
  16. Xref: newsmaster.cc.columbia.edu comp.protocols.kermit.misc:12872
  17.  
  18. Thomas A. Horsley <Tom.Horsley@worldnet.att.net> wrote:
  19. >>Or of a way to produce a UNIX man page and an HTML document from
  20. >>common (plain-text) source?
  21.  
  22. > Perl (www.perl.com is a good starting place) uses a format it calls POD
  23. > (plain old documentation) and has converters from POD to hmtl, man pages,
  24. > and many other formats (I personally hate POD, but some people love it).
  25.  
  26. Perl is a powerful scripting language. (but I do not know it yet.)
  27.  
  28. You can find and nroff to HTML translator at:
  29.  
  30.    ftp://ftp.uci.edu/pub/dtd2html/man2html2.1.0.tar.gz for a too
  31.  
  32. (I haven't tested it!)
  33.  
  34. IMHO to work in nroff, translating the source code to HTML, is better
  35. than working in HTML translating the file to nroff. I hate to see how
  36. the Unix manual pages are being dropped (for example, has Communicator
  37. a man page? And Acrobat Reader? And FrameMaker?)
  38.  
  39. I think that work on the actual nroff source, translating it to HTML
  40. if required, is a better option... but it is only my opinion...
  41.  
  42. Cheers,
  43. Igor.
  44.  
  45. -- 
  46. Igor Sobrado, UK34436 - sobrado@acm.org
  47.